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(54) System and method for propagating revisions through a communications network 



(57) A system, and method of operation, for propo- 
gating revisions through a connmunications network. 
The system includes: (1) status reporting circuitry, asso- 
ciated with a second node of the conrvnunications net- 
work, for collecting and transmitting a current status of 
second node information stored in a menrK>ry of the sec- 
ond node, (2) first information revising circuitry, associ- 
ated with a first node of the communications network, 
for receiving the current status from the second node, 
determining as a function of the curent status vtrhether 
a revision of the second node information is required 
and, if the revision is required, transmitting the revision 
to the second node to revise the second node informa- 



FIG, 



tion and (3) second information revising circuitry, asso- 
ciated with the second node of the communications 
network, for receiving a current status from a third node 
of the communications network, determining as a func- 
tion of tiie current status from the third node whether a 
revision of third node information stored in a memory of 
the third node is required and, if the revision is required, 
transmitting the revision received from the first node to 
the third node to revise the third node information, the 
revision thereby propagating through the communica- 
tions network via the first, second and third nodes 
tiiereof. 
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Description 
COPYRIGHT NOTICE 

5 A portion of the disclosure of tfiis patent document contains material which is subject to copyright protection. The 
copyright owner has no objection to the facsimile reproduction by anyone of the patent document or the patent disclo- 
sure, as it appears in the Patent and Trademark Office patent file or records, but othenwise reserves all copyright rights 
whatsoever. 

10 TECHNICAL RELD OF THE INVENTION 

The present invention is directed, in general, to communications networks and, nrK>re spectfically, to a system and 
method for distributing updates to nodes of a hierarchical communications network that cascade the updates through 
the network as a function of its hierarchy. 

BACKGROUND OF THE INVENTION 

Immeasurable gains in technology offered in personal computers ("PCs") have allowed PCs to assume roles per- 
formed only by mainframe or minicomputers in the past. Many companies and, for that matter, individual users rely 

20 largely on commerclallynavailable PCs to meet their information processing needs. Thus, it is vital that their PCs perform 
reliably. The fault tolerance of a given computer system is a sensitive issue with conpanies and individual users given 
the level of reliance they place on their computing systems. 

Initially PCs were stand-alone devices, each containing separate hardware, operating system, application software 
and user data. As use of PCs spread within business organizations, however, the need for shared data and hardware 

25 resources grew, and local area network f LAfsls") came into being. A LAN (or its more-geographically-dispersed coun- 
terpart, the wide area network C^AN")) includes a number of PCs ("clients'^ linked to one another (typic^ly t>y a high 
speed serial communicatfons link) arKi centers around a relatively high performance PC or minicomputer ("server") that 
delivers programs and data to the clients and manages system-wide resources, such as secondary storage units and 
printers. 

30 The networking concept has proven very useful, but suffers from a couple of disadvantages. First, sirK;e manage- 
ment of the network is focussed in the server, the overall performance of the network is compromised whenever the 
sender becomes a processing bottleneck Second, since progranrts and data are delivered by the server to its various 
clients, a distribution problem occurs whenever a software provider or vendor modifies one of its programs or data. The 
modified program or data must typically be distributed from the server to the client computers in a timely manner, often 

35 within a single business day In a prior art solution, the server, or a "host" computer identified by the server, is respon- 
sible for sequentially traversing each of the client computers supporting an "okJ" version of the nxxlrfied program or 
data, and then updating those client computers as necessary to implement the "new" version. In an alternate prior art 
solution, tiie server, or the host conputer, traverses each client computer, updating each to include certain ones of tiie 
sender's files. 

40 A prot>lem inherent to the prior art solutions is tiiat substantial server, or host, processing resources may be spent 
establishing a communication link with many, if not all. of the client computers, and then ipdating the same. Further, if 
the server is responsittle for performing the updates and the number of client computers being serviced by the server 
increases, the overall performance of the network may significantly be compromised as the server becomes a process- 
ing bottieneck. A system and method are needed for propagating revisions to programs or data tiirough a communica- 

45 tions network wherein the communications network and in particular the server's resowces. are neitiier compromised 
nor wasted. The inat>ility of conventional solutions to accomplish the foregoing remains a dominant obstacle to updating 
software products distributed anrK>ng various ones of tiie client computers of a communications network. 

SUMMARY OF THE INVENTION 

50 

To address the above-discussed deficiencies of the prior art the present invention provkles a system, and method 
of operation, for propagating revisions through a communications network, wherein tiie communications network 
includes a plurality of associated nodes. 

The system includes: (1) status reporting circuitry, associated with a second node of the communications network, 
55 for collecting and transmitting a current status of second node infomnatton stored in a memory of the second node, (2) 
first information revising circuitry, associated with a first node of thie communications network for receiving the cunrent 
status from the second node, detemnining as a function of the current status whether a revision of the second node 
infomiation is required and, if the revision is required, transmitting the revision to the second node to revise the second 
node information and (3) second infomiation revising circuitry, associated witii the second node of the communications 
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network, for receiving a current status from a third node of tfie connmunications network, determining as a function of 
the current status from the third node whether a revision of third node infornnation stored in a menrx>ry of the third node 
is required and, if the revision is required, transmitting the region received from the first node to the third node to vBnse 
the third node information, the revisfon thereby propagating through the communications network via the first, second 

5 and third nodes thereof. 

The present Invention therefore allows revisions to propagate automatically through a communications network. 
Nodes in the network are responsible for txith detecting when a revision to information in another node is necessary 
and transmitting the revision to the other node. "Information," as used the term Is used herein, is defined broadly to 
encompass txTtii instructions (e.^.. programs, functions, tasks, subroutines, procedures and the like) and data. The 

10 "information** sut)ject to revision by the present invention may, for example, be a computer program (allowing automatic 
distnlxition of program updates, fixes, tools and the like), computer data (e^.. documents, spreadsheets, databases, 
data files and the like), video data or the like. 

In one enrixxliment of the present invention, at least the second information revising circuitry includes memory for 
storing a sut>scn't>er list, wherein the second information revising circuitry transmits the above-described revision as a 

IS function of the content of the subscriber list. The present invention is therefore able to form the core of a fee-based 
update service, wherein sut>saik>ers pay for revisions. The amount of information revised and the frequency of the revi- 
sions may be selectable, alfowing a range of fee-based services to be offered. In a related entxxtiment, the sutiscrO^ 
list and ttie cun-ent status are suitably processed to identify a subset of the information of the subscriber list that is avail- 
at)le to a particular user or group of users, the processing therefore functioning as a filter for the subscrit)er list. 

20 In one embodiment of the present invention, the status reporting drcuitry collects and tiansmits the current status 
of the second node information to the first node at a first time, status information circuitry associated with the third node 
collecting and transmitting the current status from the third node to the second node at a second time, the second time 
sut)sequent to the first time by a period of time suffk^ent to allow the second node information to be fully revised t>efore 
the secorxJ information revising drcuitry transmits the revision to the third node. This allows orderly "waves" of revisions 

25 to propagate through the network. Alternatively, revisions may be dstrikxited In a mcxe random fashion, as one node 
determines that another requires a revision. 

In one emtxxtiment of the present invention, the second information revising circuitiy is embodied In a sequence of 
instructions operable on a second processor associated with the second node, tine revision capat)le of induding revi- 
sions to tile sequence of instructions, thereby allowing an operation of the second information revising drcuitry to be 

30 modified or altered. The information revising drcuitry itself may therefore be altowed to change or be updated. 

The communications network is hierarchical, in one embodiment of the present invention, the first node functions 
as a server for the second node, the second node functions as a server for the third node. "Hierarchical", as the term is 
used herein, means a structure of many levels wherein particular levels have control or precedence over other levels 
(e.^., higher precedence levels over lower precedence levels), and wherein a first level node may be hierarchically 

35 related to one or more secorxi level nodes, each second level node may be hierarchically related to one or more third 
level nodes, each third level node may be hierarchically related to one or more fourth level nodes, etc. Precedence may 
suitably be based upon order (e.^. sequentially), responsibility, functionality, etc. The broad scope of the present inven- 
tion therefore encompasses tree-based networks, as well as flat peer-to-peer networks. The present invention is fur- 
thermore not limited to computer networks, such as LANs or WANs, but rather is operable in telecommunication 

40 systems to update system software or data or in wireless environments, such as cellular telephony or message paging 
networks. 

In one embodiment of the present invention, the first information revising circuitry includes first security drcuitry for 
authenticating the current status received from the secorxl node t>efore the first node transmits the revision to the sec- 
ond node and the second node indudes second security drcuitry for auttienticating the revision received from ttie first 
45 node before revising the second node information. In a related embodiment, the second security drcuitry auttienticates 
the revisfon on a file-k>y-f 3e basis. Of course, ttie security drcuitry may be in the form of computer instructions, allowing 
the drcuitry to change or be updated over time. 

In one embodiment of the present invention, the first information revising drcuitry revises the second node inforrm- 
tion by logging onto the second node and transmitting a sequerK;e of commarxls to the second node to enable the see- 
so ond node to receive tiie revision. The present invention therefore operates In a conventional network environment and 
may therefore be completely transparent to ttie underiying network operating system ("NOS"). Security and other fea- 
tures of the NOS may therefore remain intact 

An advantageous emtxxliment for using and/a distributing the present invention is as software. The software 
errtxxjiment indudes a plurality of instructions which are stored to a suitable conventional memory or other equivalent 
55 storage medium. The instructions are readable and executable by one or wore network nodes having processing dr- 
cuitry. The instructions, upon execution, direct the processing drcuitry to propagate revisions through a communica- 
tions network wherein the communications network indudes a plurality of assodated nodes in accordance with the 
present invention. Exenrplary memory and storage media indude without limitation magnetic, optical, and semiconduc- 
tor, as well as suitably arranged combinations thereof. 
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The foregoing has outlined, rather broadly, preferred and alternative features of the present invention so that those 
skilled in the art may better urxJerstand the detailed description of the invention tfiat follows. Additional features of the 
invention will be desaibed hereinafter that form the subject of the claims of the invention. Those skilled in the art shouki 
appreciate that they can readily use the disck>sed conception and specific enrixxjiment as a basis for designing or nrxxi- 
5 ifying other structures for carrying out the same purposes of the present invention. Those skilled in the art should also 
realize that such equivalent constructions do not depart from the spirit and scope of the invention in its broadest form. 

BRIEF DESCRIPHON OF THE DRAWINGS 

10 For a more complete understandng of the present invention, reference Is now nnade to the following descriptions 
taken In conjunction with the acconpanying drawings. In which like nunr^ers designate like parts, and In which: 

FIGURE 1 illustrates a block diagram of a conventional hierarchical communications network In which the principles 
of the present Invention may advantageously be Implemented; 
75 FIGURE 2 illustrates an isometric view of an exemplary processing system node chat provides a suitable environ- 
ment within which the present Invention may t>e implemented and operated in accordance with the conrimunlcatlons 
networkof FIGURE 1; 

FIGURE 3 illustrates a high-level bkx:k diagram of an exemplary microprocessing circuit that may surtat>ly be asso- 
ciated with the processing system of FIGURE 1 and that provides a suitable environment within which the present 
20 invention may be implemented and operated; 

FIGURE 4 Illustrates a high-level bkx^k diagram of a single exemplary branch of the communications network of 
FIGURE 1; and 

FIGURE 5 illustrates a ftow diagram of an exemplary method of operation for propagating revisions through the 
communications networi^ of FIGURE 1 in accordance with the principles of the present Invention. 

25 

DETAILED DESCRIFRON 

Referring initially to FIGURE 1, Illustrated Is a block diagram of a conventional hierarchical communications net- 
wori^ a computer networic (generally designated 100), in which the princq^les of the present invention may advanta- 
30 geously t>e implemented. Exemplary network 100 includes a server node 110 and a plurality of conventional client 
nodes 120a-120c. 130a-130f and 140a-140h. "Include," as the temri is used herein, is defined as inclusion without lim- 
itation. A YKxJe," as the term is used herein. Is defined as any junction, end or connection point, station, terminal or the 
like, whether portable or r)ot. that is capable of communicating signals, or information, within communications network 
100. 

35 Server node 110 may suitably, and conventionally be sharable by client nodes 120a-120c. 130a-130f and 140a- 
140h. Sender node 110 and client nodes 120a-120c, 130a-130f and 140a-140h may suitably be associated witii one 
another, either directiy or indirectly, by any conventional means, including comnrtunication links, portal devices (e.^., 
routers, bridges, gateways, switches, etc.) or the like. "Associated with," as tiie term is used herein, means to include 
within, interconnect with, contain, be contained within, connect to. couple with, be communicable with, juxtapose, coop- 

40 erate witii. Interleave or the like. 'X)r." as the term is used herein. Is inclusive, meaning and/or. 

The illustrated association of nodes 110, 120a-120c, 130a-130fand 140a-140h suitatrfy fadlitates resource sharing 
as well as the t>alancing of resource requests among ones of the nodes, techniques that are known in the art. Commu- 
nication armng various ones of the nodes may suitably include the transmissbn and reception of signals. Each com- 
munication signal may suitably be divided Into packets, frames, messages, sequences of data or any other variation of 

45 a physical quantity for conveying information. A typical signal may suitat)ly Include a collection of related data itents. 
such as discrete data, address or instruction objects that may be used to communicate information t^etween various 
ones of tiie nodes. 

In an advantageous embodiment, as will be cfiscussed in greater detail with reference to FIGURES 4 and 5, re^- 
sions to at least a portion of tiie information stored on server 1 10 may suitably t>e propagated on a level-by-level t>asis 

50 through communications network 100 in accordance with the principles of the present invention. "Revisions," as tiie 
term is used herein, means changes, nxxjiflcations, additions, deletions, adjustnents, alterations, variations, customi- 
zations, and the like. More particularly, at least one of tiie second level nodes 120a-120c collects and transmits a sec- 
ond level current status of information stored in the one or more second le^el nodes. The second level current status of 
information may suitat)ly be for the entire level or for irxlividual ones of second level nodes 120a-120c. Server 1 10, a 

55 first level node, receives tiie second level current status of Information and determines, as a function of the second level 
current status of information, whether a revision of one or nfK>re of the second level nodes' information is required. If tiie 
revision is required, server 110 transmits the revision of the second level node information to the one or more second 
level nodes 12pa-120c. 

After the revision, the one or more second level nodes 120a-120c may suitably receive a third level current status 
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of information from at least one third level node 130a-1 30f. and determine, as a function of the third level current status 
of information, whether a revision of the one or more third level nodes' information is required. The third level current 
status of infornfiation may similarly be for the entire level or for individual ones of third level nodes 130a-130f. If the third 
level revision is required, the one or nnore second level nodes 120a-120c transmit at least part of the revision received 

5 from server 110 to the one or more third level nodes 130a-130f to thereby revise the third level node information. 

An inportant aspect of the atxive-identified and -desaibed embodiment is the breadth^irst-type, or "fan-out." 
update. More particularly, revisions to the first level node information are suitably propagated through ones of the sec- 
ond level nodes, then the third level nodes, and so on, such that the revisions to the first level node information may be 
propagated through communications network 100 in an exponential manner. 

10 Turning to FIGURE 2, illustrated is an isometric view of an ^emplary processing system, a PC (generally desig- 
nated 200). Processing system 200 is capatJe of functioning as any node 110. 120a-120c, 130a-130f and 140a-140h 
vnthin exemplary communications network 100. Processing system 200 suitably includes a chassis 205, a display 
device 210 and a keyboard 215. Chassis 205 includes a hard disk drive 220 and a floppy disk drive 225. Roppy disk 
drive 225 may suitably be replaced by or combined with other conventional structures for transfening data or instruc- 
ts tions. including tape and compact disc drives, telephony systems and devk;es (including telephone, video phone, fac- 
simile or the like), network communication ports and the like. 

Chassis 205 is partially cut-away to illustrate a battery 230, a clock 235. a detached local memory 240 and process- 
ing circuitry 245 ("CPU'), all of which are suitably housed therein. Detached local memory 240 is operative to store data 
and instructions. Tlie stored instructk>ns may suitably be grouped into sets of tasks, including programs, procedures, 

20 subroutines, functions, and the like. Processing circuitry 245, which is associated with detached k>cal menrK)ry 240, is 
operative to execute selected ones of the instructions stored therein to propagate revisions to the stored data and 
instructions through communications network 100 in accordance with the principles of the present invention. 

In an advantageous embodiment, display device 210 is operative to provide a display area 250 that is accessit}le 
to executed ones of tiie plurality of instructions, and that is capat>le of displaying a graphical user interface. Further cou- 

25 pled through individual conventional connectors (not shown) on chassis 205 are a mouse 255 and a printer 260. Exem- 
plary peripheral devices 210. 215. 255 and 260, all of which are associated with processing circuitry 245, allow 
processing system 200 to interact with a user. Exenplary peripheral devices 210. 215, 255 and 260 may suitably be 
replaced by or combined with other conventional user interfaces. • 

Although processing system 200 is illustrated having a single processor, a single hard disk drive and a single local 

30 tuemocy, processing system 200 may suitably be equipped witii any multitude or combiruition of processors or storage 
devices. Processing system 200 may, in point of fact, be replaced by, or confined with, any surtaWe node operative in 
accordance with the principles of the present invention, including sophisticated calculators, and hand-held, laptop/note- 
book, mini, mainframe and super computers, telephony systems (e.g., sound, video, data, etc.), message paging sys- 
tems, portal devices and tiie like, as well as network combinations of the same. 

35 Conventional processing system architecture is more fully discussed in Computer Organization and Architecture, 
by William Stallings, MacMillan Publishing Ca (3rd ed. 1993); conventional processing system network design is nrtore 
fully discussed in Data Network Design, by Danen L Spohn, McGraw-Hill, Inc. (1993): and conventional data commu- 
nications is nx>re fully discussed in Data Communications Prindoles. by R. D. Gitiin, J. R Hayes and S. B. Weinstein, 
Plenum Press (1992) and in The Inwin Hancftxwk of Telecommunications, by James Harry Green, Invin Professional 

40 Publishing (2nd ed. 1992). Each of the foregoing put)lications is incorporated herein by reference. 

Turning to FIGURE 3. illustrated is a high-level block diagram of an exemplary microprocessing circuit (generally 
designated 300) that may suitat>ly be associated with a processing system, such as PC 200 of FIGURE 2. Micro- 
processing circuit 300 includes detached local menK>ry 240, processing circuitry 245, bus controller drcurtry 305, a 
conventional read-only memory ("ROM"^ 310 and a set of peripheral ports 315. A host bus 320 is shown and is suitably 

45 operative to associate processing circuitry 245. detached local memory 240 and bus controller circuitry 305. In accord- 
ance with the illustrated erhbodiment, detached local memory 240 may suitably include random access menfX)ry 
("RAM^, and processing drcurtry 245 may suitably indude one or more processors acting in concert. 

An input/output ("lA^) bus 325 is shown and is operative to assodate bus controller drcuitry 305. ROM 310 and 
the set of peripheral ports 315. The set of peripheral ports 315 may suitably couple I/O bus 325 to peripheral devices 

50 210. 215, 255. and 260 of FIGURE 2 for communication therewitii. Included among the set of peripheral ports 315 may 
suitably be a serial or a parallel port Bus controller drcuitry 305 provides suitable means by which host bus 320 and 
I/O bus 325 may be assodated, tiiereby providing a path and management for communication therebetween. In accord- 
ance with the illustrated embodiment, host bus 320 is relatively fast to fadlrtate rapid communication between process- 
ing drcuitry 245 and detached local menx>ry 240 and is typically burdened with as few components as possil}le to 

55 maximize its speed. I/O bus 325 is allowed to run at a slower pace with respect to host bus 320 because its speed is 
less critical. Each of the lines of the buses 320, 325 require a drive current to carry signals thereon. Accordingly, the 
present invention operates in conjunction with a conventional system controller (not shown) that supplies the required 
drive current. Of course, the present invention may also suitat)ly function within an architecture that only has a single 
bus. 
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In alternate prefenred embodiments, microprocessing circuit 300, in whole or in part may be replaced by, or com- 
bined wHti, any ottier suitable processing circuitry, including programmable logic devices, such as progranrvnable array 
logic CPALs*) and programmable logic anrays (TLAs*), digital signal processors ("DSPs"), field programmable gate 
arrays ("FPGAs'^, application specific integrated circuits ("ASICs"), very large scale Integrated drcuits CVLSIs") or the 

5 like, to form the various types of circuitry descrft>ed and claimed herein. 

Turning momentarily to FIGURE 4, Illustrated is a high-level block diagram of a single exemplary branch (generally 
designated 400), or a collapsed hierarchy, of communications network 100 of FIGURE 1 . Exenrplary server 110 and cli- 
ent nodes 120a and 130a form a hierarchical communications path wherein the illustrated nodes are suitably associ- 
ated via conventional communication links 405 and 410. respectively. FIGURE 4 is presented for the purposes of 

10 illustration in connection with the discussion of FIGURE 5 only. Although the illustrated embodiment focuses upon a 
tree-based hierarchical networK those of ordinary skill in the art will realize that the principles of the present inverttion 
are applicable in any suitably arranged communications networking environment (e,^., peer-to-peer networks, etc.). 
The present invention provides a means by which revisions to information associated with one or more first \e^e\ nodes 
may suitably be communicated to one or more second level nodes, from at least one of the one or more second level 

IS nodes to one or more third nodes, from at least one of the one or nwre third level nodes to one or more fourth nodes, 
etc. The present invention therefore fedlitates the propagation of re/isions through a communications network at an 
exponential rate. 

Turning to FIGURE 5, illustrated is a flew diagram of an exeirplary method of operation of communications network 
100 for propagating revisions through branch 400 of FIGURE 4, and nrwre particularly, server 110 and client nodes 
20 1 20a and 1 30a. in accordance with the present inventbn. The present discussion is undertaken with reference to FIG- 
URE 4, and it is assumed that each of exemplary nodes 1 10, 120a and 130a includes a suitable processing means, 
such as microprocessing circuit 300 of FIGURE 3 or other suitable implementation capable of providing equivalent func- 
tionality An exerrplary source code embocfiment is attached hereto as APPENDIX A and is incorporated herein by ref- 
erence for all purposes. The exemplary embodiment is written in conventional Kbm Shell code for use with a UNIX 
25 environment. System V Release 4 ("SVR4^. 

For purposes of discussion, it is further assumed that server node 1 1 0 receives revisions to information stored in a 
memory associated therewith. The revisions may suitably be received from any of a number of sources, including soft- 
ware prcvidersAvendors, for example. 

The illustrative process begins when client node 120a scans its associated memory studying the information stored 
30 thereon (e.^.. files, datat>ase, data configurations, programs, routines, sutxoutines, functions, tasks, and the like) and 
generates a status report (process step 500). The status report represents the current status of client node 120a infor- 
mation, and may suitably include an identifier to identify various client node information, a version number associated 
with various client node information, a revision date associated with various dient node information, or the like. The 
scanning process may suitatily be initiated externally by server node 1 10 or internally t>y client node 120a. In either sit- 
as uation, the initiation may suitably be performed periodically or aperiodically. 

Client node 120a. possibly using one of peripheral ports 315, transmits the status report to server node 110 
(input^output step 505). Server node 1 10, possibly using one of its peripheral ports 315, receives the transmitted status 
report and surtably verifies the accuracy of the transmission (process step 51 0). Techniques for verifying the transmis- 
sbn of data are known. 

40 In an advantageous embodiment, server node 1 1 0 is further operative to autiienticate the current status of dient 
node 120a by logging onto dient node 120a, and confinning the information witiiin tiie received status report. "Autiien- 
ticate," as the term is used herein, means to establish the auttienticity of, prove genuine or the like, induding confirm, 
con-oborate, prove, substantiate, validate, verify, or the like. For exanrple. if the received status report indicates that di- 
ent node 120a indudes version 1.0 of software package XYZ, server 1 10 may suitably log onto client node 120a to con- 

45 f inn that client node 120a in fact indudes version 1 .0 of software package XYZ. Often times, stored information, such 
as software package XYZ. indudes a plurality of files. In a related emtxxiiment therefore, server 1 10 authenticates tiie 
status report on a file4>y-file basis. 

Server node 1 1 0, if the status report was correctly received, determines as a function of the received status report 
whether a revision of dient node 120a stored information is required (dedsional step 515). In anotiier advantageous 

50 embodiment, a suitable inventory is maintained, either directiy or indirectiy, by server node 110. The inventory indudes 
a list of the infonnation maintained, used, provided, or the like by server node 110, and posstoly dient node 120a. The 
determination of whether dient node 120a stored information requires revisbn is suitat>ly performed by comparing the 
status report witti the inventory ttiereby identifying information ttiat (1 ) is missing from client node 1 20a, (2) may suitably 
be removed from dient node 120a. (3) is not a recent version. (4) is expired, such as under tiie terms of a license a^ee- 

55 ment, or the like. Conventional techniques for performing comparisons are known. 

In connection witii licensing arrangements, tiie above-referenced identification process may suitattly be used to 
identify valid, invalid, out-of-date or the like sut>saiber information maintained by dient node 120a, an aspect of tiie 
present invention that is discussed in greater detail hereint>elow. 

If dient node 120a stored information requires revision (YES branch of dedsional block 515), server node 110 suit- 
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ably creates an information rension file for transmission to client node 120a (process step 520). An exemplary informa- 
tion revision file may suitably indude programs, functions, tasks, subroutines, procedures, documents, spreadsheets, 
databases, data files, data configurations, or the like. The revision file may also suitably include a set of instructions for 
execution by client node 1 20a. the executed set of instructions may suitably direct client node 1 20a to install the remain- 

5 der of the information revision file, perform transmission verifications, security or the like. 

Server node 110, possit)ly using one of peripheral ports 315, suitably transmits the revision file to client node 1 20a 
(input/output step 525). Client node 120a, again possibly using one of its peripheral ports 315. receives the transmitted 
revisions file and verifies the accuracy of the transmission (process step 530). If the transmission was conrectly 
received, the stored information on client node 120a is updated using the received revision file (process step 535). 

10 The foregoing update may suFtat)ly be performed in any one of a numt)er of ways, for example, server node 110 
may suitably update client node 120a stored information by logging onto client node 120a and one of: 

(a) perform the update in a conventional 'Vnaster-slave'-type environment (/.e.. comnrunications session in which 
one side, called the master, initiates and controls the session, and the other side, called the slave, responds to the 

15 master's commands), and 

(b) transmit a sequence of commands to client node 120a that upon execution by client node 120a, enable client 
node 120a to perform the update. 

In another exanrple. client node 120a receives the revision fDe from server 110, txjffers the received revision file, and 

20 suitably performs the update. Gient node 1 20a may also receive the atKve-identif ied set of instructions as part of the 
revision file, the set of instructions, when suitably executed by client node 120a, direct client node 120a to install the 
remainder of the txjffered revision file, or altematively, to perform transmission verifications, security or the like. 

In accordance with the illustrated embodiment, client node 120a. a second level client in network branch 400. may 
suitat>ly function as a temporary "server" to client node 130a, a third level client in network branch 400. 

25 The illustrative process continues when client node 130a scans its associated menrK>ry studying the information 
stored thereon (e.^., files, database, data configurations, programs, routines, subroutines, functions, tasks, and the like) 
and generates a status report (process step 540). The status report represents the current status of client node 130a 
information, and nriay suitat)ly include an identifier to identify various client node information, a version number associ- 
ated with various client node information, a revision date associated with various client node information, or the like. The 

30 scanning process may suitatsly be initiated externally by client node 120a or internally by client node 1 30a. In either sit- 
uation, the initiation may again surtat)ly be performed periodically or aperiodically 

Client node 130a. possibly using one of peripheral ports 315, transmits the status report to client node 120a 
(input/output step 545). Client node 120a, possibly using one of its peripheral ports 315, receives ttie transmitted status 
report and suitat)ly verifies ttie accuracy of the transmission (process step 550). 

35 In an advantageous emtxxliment client node 1 20a is further operative to authenticate the current status of client 
node 130a by logging onto client node 130a. and confirming the information within the received status report. In a 
related embodiment, the authentication of the status report, portions of which may again include a plurality of files, is 
performed on a file-by-file basis. 

Client node 120a, if the status report was correctly received, determines as a function of the received status report 

40 whettier a ranston of client node 1 30a stored information is required (decisional step 555). In yet arK>ther advantageous 
errixxiiment, a suitable inventory is maintained, either directly or indirectiy, by client node 1 20a. The inventory includes 
a list of ttie information maintained, used, provided, or the like by client node 120a, and possit)ly client rxxJe 130a or 
server node 110. The determination of whettier client node 130a stored information requires revision is suitat>ly per- 
formed by comparing the statos report with the inventay theret^y identifying information that (1) is missing from client 

45 node 1 30a, (2) may suitably be removed from client node 1 30a, (3) is not a recent version. (4) is expired, such as under 
the terms of a license agreement, or tiie like. 

In connection with licensing arrangements, the above-referenced identification process may suitably be used to 
identify valid, invalid. out-of-<Jate or the like sut>scriber information maintained by client node 130a, an aspect of ttie 
present invention ttiat is discussed in greater detail hereinbelow. 

50 If client node 1 30a stored informatfon requires revision (YES branch of decisional block 555). client node 1 20a suit- 
ably aeates an information revision file for transmission to client node 130a (process step 560). The information revi- 
sion file may suitat)ly include, at least in part, the revision file received by client node 120a from server node 110. 

An exemplary information revision file may suitat)ly include programs, functions, tasks, subroutines, procedures, 
documents, spreadsheets, databases, data files, data configurations, or the like. The revision file may also suital)ly 

55 include a set of instructions for execution by client node 1 30a. ttie executed set of instructions may suitably direct client 
node 130a to install the remainder of the information revision fine, perform transmission verifications, security or the 
like. 

Client node 120a, possbly using one of peripheral ports 315, suitably transmits the revision file to client node 130a 
(input/output step 565). Client node 130a, again possibly using one of its peripheral ports 315, receives the b'ansmitted 
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revisions file and verifies tfie accuracy of the transmission (process step 570). If the transmission was correctly 
received, the stored information on client node 130a is updated using the received revision file (process step 575). 

The foregoing update may suitak)ty be performed in any one of a number of ways, for exanple. client tKxle 120a 
may suitably update client node 130a stored information by logging onto client node 130a and one of: 

5 

(a) perform the update in a conventional Inaster-slave'-type environment {i.e., communications session in which 
one side, called the master. Initiates and controls the session, and the other side, called the slave, responds to the 
master's commands), and 

(b) transmit a sequence of commands to client node 130a that upon execution by client node 130a, enable dient 
10 node 1 30a to perform the update. 

In another example, client node 130a receives the revision file from client node 120a. buffers the received revision file, 
and suitably performs the update. Client node 130a may also receive the above-identified set of instructions as part of 
the revision fOe. the set of Instructions, when suitably executed by client node 130a. direct client node 130a to Install the 

75 remainder of tfie buffered revision fine, or afternativety. to perform transmission verifications, security or the Ilka 

The akx]ve-ldentifled and -descrfoed process may suitat>ly be performed in a conventional network environment 
and may further suitably be transparent to the underlying network operating system ("NOS^. This feature enable con- 
ventional security and other features of the NOS to remain intact. 

An irrportant aspect of various embodiments of the present invention, is that either client node 120a or 130a may 

20 suitably Include a sequence of instmctions for performing at least a portion of the atxive^lescribed update process 
which itself Is subject to an update by the received information revision f 3e. The sequence of instructions may suitably 
t>e revised by the received revision file, and then surtat)ly executed, thereby allowing one or wore operations of one of 
client node 120a or 130a to be nrKxiified and allowed to change or t>e updated over tima 

Another irrporlant aspect of the present Invention as exemplified by the illustrated embodiment, is that client node 

25 1 30a stored information may suitak}ly be revised, at least in part, by the revision file received t>y client node 1 20a from 
server node 110. The revision thereby propagates through the communicatfons network via the first, second and third 
nodes thereof. 

In a related embodiment the status report generated by client node 1 20a may be transmitted from client node 1 20a 
to server node 1 10 at a first time, whereas the status report generated by client node 130a may then be transmitted 

30 from client node 130a to client node 120a at a second time. The second time may advantageously be subsequent to 
the first time by a period of time sufficient to allow client node 120a information to be fully revised before client node 
120a transmits the revision to client node 130a. A furtiier aspect of the present invention therefore is allowance of 
orderly 'Waves" of revisions to propagate through communications network 100. In alternate embodiments, revisions 
may suitably be distrikxited in a more random fashion, as one node determines tiiat another rKXIe requires a revision. 

35 An advantageous application of the present invention is to sut)scriber-k)ased software distrfoution systems. "Sdb- 
scrik>er-fc>ased systems." as tiie phrase is used herein, means electronic communications systems wherein a party, the 
*'sut>scrft>er." contracts with a vendor, distributor, licensor or the like to receive and pay for a certain number of issues, 
versions, or the like of a particular software package, group of software packages, electronic services, or tiie like. More 
particularly, at least one of server rxxie 1 10 or client node 120a includes memory for storing a sut}scrfoer list, assoclat- 

40 Ing subscribers with flieir subscrbed to services. Server node 1 10 and client node 120a transmit revision files, at least 
in part, as a function of the content of the sut>scriber list. The present invention tiierefore may suitably form the core of 
a fee-based ipdate servk;e. wherein subscribers pay for revisions. The amount of information revised and tiie fre- 
quency of the revisions may be selectable, allowing a range of fee-k>ased services to be offered. In a related emtxxJi- 
ment. the suk>saiber list Is associated with a restricted list The restricted list, when suitat>ly processed In association 

45 with tiie subscriber list, identifies a subset of the information of the subscriber list that is availat)le or unavailable to a 
particular user or group of users, such as a group of users associated by geographical location, for example. The 
restricted list may therefore functions as a fitter for the sut>scrlber list. 

The propagation of updates tiirough a sut>scrit>er-t)ased systems may be particulariy advantageous, not only over 
WANs, such as ttie Internet, but also tiirough catrie television systems, such as those providing pay-per-view and 

50 demand-television, including emerging services for receiving video games and other interactive services. 

Rom the above. It is apparent that the present invention provides a system, and method of operation, for propagat- 
ing revisions ttvough a communications networK wherein the communications network includes a plurality of associ- 
ated nodes. The system includes: (1) status reporting circuitry, associated with a second node of the communications 
network, for collecting and transmitting a current status of second node information stored in a memory of tiie second 

55 node, (2) first Information revising drcuitry. associated with a first node of the communications network, for receiving the 
current status from the secorvJ node, determining as a function of tiie current status whether a revisfon of the second 
node information is required arxl. if the revision is required, transrratting the revision to the second node to revise the 
second node information and (3) second Information revising circuitry, associated with the second node of the commu- 
nications network, for receiving a current status from a third node of the communications network, determining as a 
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function of the cun-ent status from ttie ttiird node wtiether a resnsion of third node information stored in a memory of the 
third node is required and, *rf the revision is required, transmitting the revision received from the first node to the third 
node to revise the third node information, the revision thereby propagating through the communications network via the 
first, second and third nodes thereof. Revisions are therefore allowed to propagate automatically through a communi- 

5 cations networK wherein various nodes witiiin the communications network are responsible for both detecting when a 
revision to information in another node is necessary and transmitting the revision to the other node. 

The broad scope of tiie present invention is not limited to tree-t}ased hierarchical networks of the type set forth in 
FIGURES 1. 4 and 5. but also includes other conventional networks configurations, such as peer-to-peer communica- 
tions networks. The propagation of revisfons is also not limited to a first node to a second node to a tiiird node progres- 

10 sion, but rather includes revision of a first node propagated to one or wore second nodes, from at least one of the one 
or more second nodes to one or more third nodes, from at least one of the one or more third nodes to one or more fourth 
nodes, etc., tiiereby enabling not only the sequential revision of serially associated nodes, but also a hierarchical fan- 
out updating of a plurality of nodes. 

TTie present invention is also not limited to pure "computer-based" communications networks, such as LANs or 

15 WAfMs, but may also suitably be implemented in telecommunication systems to update system software or data or in 
wireless environments, such as cellular telephony or message paging networks. To that end, the principles of the 
present invention may suitably be associated with any network element functioning as a node, including routers, 
bridges, gateways, switches, or other conventional portal devices, satellites, relay stations, or the like. While the princi- 
ples of the present invention have been descrbed in detail, tiiose skilled in the art should understand that they can 

20 make various changes, sut>stitutions and alterations herein without departing from the spirit and scope of the invention 
in its broadest form. 
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APPEWPK A 
"SENDLIST" SOURCE CODE 



CMO = ' bascname SO ^ 

USAGE-'Usagc: JCMD [ -d | [ -s servcrlD J' 

KSHOK»no 

echo yes | read KSHOK 

if icsi -SKSHOK* « "no-; then 

ificsfS{RETRYING^KSH:-no}- - •yes": then 

echo -SCMD: ERROR: not running witb kshSS - aborting! ' 

echo *SCMD: ERROR: not running with ksbSS - aborting!' | 

/bin/mail cxptools 

RC-2 
eliftestSjr-gtO; tben 

RETRYlNa KSH-'yes" SSHEU. $0 'S^* 

RC-$7 

else 

RETRYING KSH-"yes" SSHELLSO 
RC-$? 

fi 

exit SRC 

fl 



0 < emsg 

if 

If This routine prints out error messages and mails them to eitptools 
emsgO { 

typeset MSG^-SCKfD: ERROR: SI - aborting!' 

typeset lXX}->SA0KfRUG/$SERVERID/local/sendplistout 

typeset ECODE ECMD 

if test -n "$2"; then 

echo SZ I read ECMD ECODE 

MSG^'SMSGXnError 'SECODE' reported by SECMD ' 

n 

echo -SMSG- >&2 
{ 

echo "Subject: sendptist error!* 
echo 

echo "SMSC 

if test •$ SLOG; tben 

echo '\nHere is the complete seodptist log file:* 

echo ' ' 

pr -o4 -t StXKj 

echo • ■ 

fl 

) I /bio/mail exptools 

} 



ff < ejitractsection 

M This routine extracts given sections of input files that arc terminated by 
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H ihe EOF line. 

extractsectiooO { 
integer sectioD^Sl 
typeset inputftle*!! 
integer is I 

typeset LINE donc-falsc 

while not $done read UNE; do 
if ((i > section)): then 

done«true 
clif test ^SUNE" « "$EOf; then 

((i += D) 
clif ((i " " section)); then 

echo "$UNE* 

n 

done < SinpucTile 

) 



$ ^ ■■< main 



GETOPT-$(getoptds: 
if(($?!«0));thcn 

echo "SUSAGE" 

exit 2 

fi 

set - SGETOPT 

#set -e ' Exit on any error 

debugs-"" 
SERVERID="" 
for arg in *S®*; do 

case "Sarg" in 

-s) 

S£RVERID-$2 
shift 2 

^) 

debug"-: 
shift 

-) 

shift 
break 

csac 
done 

if test < -f SADMRUG/global/config; then 
emsg "Can't find RUG global config file* 
exit! 

n 

. SADMRUG/globai/config 



if test -n 'SSERVERID*; then 
FOUND«faIsc 
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for ID in SSERVERIDUST; do 

if test -SID' » 'SSERVERID-; then 
FOUND- true 

fi 

done 

if not SFOUND: then 

emsg 'Unknown scrvcrid 'SSERVERID' given* 
exit 2 

fi 
else 

if test -z -SDEFAULTSERVERID"; then 
emsg 'Default server id missing" 
exit 2 

fi 

SERVERID=$DEFAULTSERVERID 

fi 

exec > JADMRUG/SSERVERID/local/scndplist.out2>&l 
echo *Start *date'\n* 

CASCADEFIL£»SADMRUG/SSERVERID/global/cascade 
if test -f SCASCADEFILE; then 

cp SCASCADERLE SADMRUG/local/cascadefile 

chmod 664 SADMRUG/Iocai/cascadefile 

fi 

. SADMRUG/global/linkconfig SSERVERID 

NETINFO»$(ccbo SSERVERID STYPE | SNETCMD) 
if test -z'SNETINFO": then 

emsg 'Unable to acquire network information' 

exit 2 

fi 

echo •Networking information: SNETINFO' 

unppkgHst^ /usr/tmp/SSpkglist 
tmpplist~/usr/tmp/$Splist 
tmpexcludes/usr/tmp/SSexclude 
tmpignore » /usr/tmp/SSignorc 
mkperrs » /usr/tmp/SSmkperrs 
errfile s /usr/imp/SSerrfile 
tmpsubfile=»/usr/tmp/SSsubfile 

tmpnist='Stmppkglist Stmpplist Stmpexclude Stmpignore Smkperrs Serrfile Stmpsubfile 

rctval=0 
trap ' 

rerval= I 

exit 
' 1 23 15 
trap * 

rm -f Stmpflist 

exit Srecval 
• EXIT 

cd 

rm -f adm/upd 1 . 1 /Itb/cpio.new 9 Remove emergency update list 

echo -\nComputing the subscription list ..." 
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\ 

echo The SLOGNAME uscnd uses the alias 'SLOCALCUENTID' to subscribe to the 
following STYPE tools from SSERVERID*:' 

cat SSUBSCRUST | f Combine «aU« subscr-lisc rUei 

Clcai^omm | 

scd 7"»/d- I 

son -f > Stmpsubfile 

if test -5 Stmpsubfile: then 

pr -o4 -t -4 Stmpsubfile 

else 

echo "NONE!* 

n 

cat SSUBSCRUST | # Combine *aU* subscr-list fUes 

CtcanComm | 

scd 'rrij/d; s/*!/r | 

son -f > Stmpsubfile 

if test -s Stmpsubfile; then 

echo' rejecting these tools:' 

pr -o4 -t -4 Stmpsubfile 

fi 

} > SADMRUG/local/subscrtist 
chmod 664 SADMRUG/local/subscrlist 

echo *\nConipuUng checksums...* 

( 

> Scrrfile 

> Smkperrs 
{ 

cat SEXCLUDELIST 0 Combine «all« exclude-list files 

genlinkdirs SSERVERID 
} I mksed > > Stmpignorc 

(find.! -name V -print 1 1 echo 'find $?' >$errfUc ;} | 

{ scd -c 'sin./!!' .f Stmpignorc 1 1 echo "sed $7" >$errfilc ;} | 

{ STADMRUG/bin/mkplist -m 2> Smkpcrrs 1 1 

echo'mkplistS?- > Scrrfile;} | 
{ sort -u II echo 'son $7' >SerrfUc ;) 

if test -s Scrrfile; then 

if test -s Smkpcrrs; then 
cat Smkpcrrs > > SADMRUG/SSERVERID/locai/sendplisLout 

fi 

emsg 'Failure preparing client plist report' '${< Scrrfile)' 
exit 2 

else 

echo -SEOF' 

fi 

) > Stmpplist 
chmod 664 Stmpplist 

eval S{debug:-f-*cp Stmpplist SADMRUG/SSERVERID'} 

if ((S(TZ°GMT date +%H) < 2»: then # if before 2AM GMT 

integer WArrnME-RAfaX)M%t800 # set 1/2 hour random delay 

echo *\nWaitiog SWATTTIME seconds to prevent server overload" 
sleep SWAirnME 

fi 

echo "VoScDdiog to SSERVERID' 
echo 'SNETINFO- | 

Sdebug SSENDCMD -u $SERVERID_UX}NAME -f ijc/SSERVERID/SLOCALCUEKnD.SYRDAY Stmpplist 
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20 



> Scrrfile 

cat SSUBSCRUST | if Combine *all* subscr-ttst files 

ClcanCooini | 
sort -u 

echo •SEOF* 
{ 

cat SEXCLUDEUST 0 Combine *a»* exdude-lUt files 

jenlinlcilin SSERVERID 

}| 

CleanComffl | 
son -u 

echo "SHOP 

If test 'Z 'SDEFAULTLOCAIiD*; tbca 

echo *0:$tjOCALCLIENTID:S(uiiame •ii):SLOGNAME:S(uname -rvm)* 

else 

typeset UNKDIR-SADMRUQ/SDEFAULTLOCAUD 
typeset RJE-$H(»4£/rje/SDEFAULTLOCALID 

echo *0:SLOCALCLl£hmE)/SD£FAULTLOCAUD:$(iinuiie •n):SLC»GNAM£.S(umunc -rvm)* 
if test -f SUNKDIR/scrver/exptab; then 
sort SUNKDtR/server/exptab 

fil 

while IFS- : read CLIENT REST: do 
If test -r SRJE/SCUENT.pkg: then 
integer COUNT-0 

exiractsectioo 3 SRJE/SCUENT.pkg | 
white n=S-: read COUNT CT ND UID OS: do 
25 ((COUNT +- I)) 

echo -$COUNT:$CT:SND:$Un>:$OS- 
done 

fi 

done 

fi 

30 echo 'SEOF* 

) > Stmppkgtist 
cbmod 664 StmppJcglist 

eval S{debug:+'cp Stroppkglist SADMRUG/SSERVERID") 

35 echo 'SNETINFO* | 

SdebugSSENDCMD -u SSERVERID_LOGNAM£ -f rje/SSERVERID/$LOCALCUENTID.plcg Stmppkglist 

if ( -5 Smkpcrrs ); then 
{ 

echo 'Subject: mkpltst errors on SUDCALCUENTIDVn' 
40 5cd 's/"/SU)CALCUENTID:scndplist:$TYPE:/- Smkperrs 

)l 

/btn/mail SSERVERMAO. 

Log the error messages 
echo 'Errors:* 
^ cat Smkperrs 

fi 

rm-r/tmp/shSSa 
echo '\aFinish ^date'* 

50 



55 
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SENDUPPT " SOURCE CODE 



CMD='basenaffle SO' 

USAGE= "Usage: $CMD [ -cdprR J ( -I locallD ] I -i threshold ] clicnf 

KSHOK-no 

echo yes | read KSHOK 

if test -SKSHOK- - "no"; then 

iftc$i*${RErRYING_KSH:-no}" «- *ycsMhcn 

echo *%CMD: ERROR: Not running with ksh88 - aborting!* 
RC=2 
elif testSJtf -gtO; then 

RETRY1NG_KSH- "yes" SSHELL $0 
RC-$? 

else 

RETRYINO KSH « 'yes* SSHELL $0 
RC-$? 

fi 

exit SRC 

fi 

alias -X echos3*prim 



25 * < cmsg 

U This routine prints out error messages and mails them to exptoots 
cmsgO { 

typeset MSG »*SCMD: ERROR: SI - aborting!" 
typeset LOG eSoutfile 
typeset ECODE ECMD 

if test -n "S2'; then 

echo S2 I read ECMD ECODE 

MSG="SMSG\nError SECODE' reported by SECMD ' 

35 fl 

ccho-SMSO" >&2 
{ 

echo 'Subject* scndupdates error!' 
echo 

echo 'SMSG* 
if test -s SLOG: then 

echo 'NnHere is the end of the sendupdate log file:" 

echo ' ' 

tail SLOG I pr -o4 -t 

echo • ' 

fl 

} I /bin/mail cxptools 



# < findclicnt 

50 » 

If This routine returns a list of machines of the type defined by the first arg 
findcliemO { 
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machines type- -$1 | sort 



0 ■ < cteanupctieni 

M This rounoe removes old fje files for a designated client. 

cleanupcitcot() { 

typeset CU^mD-S I today«S2 
typeset nnpattcrn todayfile 

yr-*date'+*y" 

lastyr" 'cxpr $yr - T 

${dcbug} rm -f $RJE/$CUENTID.HIasiyr>» $RJE/$CUENTID.difP» 
rmpattem«*SRJE/SCUENTtD ${yr}«* 
todayfile- -SEaE/SCUEKTID.Stoday* 
for X in Snnpaiiem: do 

If test •Stodayfilc* -a '$x' !- •$nnpattcm*; then 

S{debug} rm Sx 

n 

done 

) 



U < ddctefUes 

25 U This command deletes files from a client 

deletefilesO { 

Sdebug delfile -v -p SEXPPKGID < -P SEXPPWD -M SSERVERMAIL 'S^* naffle--SCUENTID 

} 

30 

» deletedirs 

U This command deletes directories from a client 
deletedirsO { 

35 Sdebug rrmdir -v ^ SEXPPKGID -c -P SEXPPWD Salmid -M SSERVERMAIL *SQ' name- -SCLIENTID 

\ 

p < senddeinies 

# 

^ » This routine sends the commands lo delete files from a client 

senddelfiicsO { 

typeset CUENTID-Sl diffile-S2 

typeset pattern-**- \( * ordinary (nonnlir) file pattern 

if (( J(grcp -c "Spattem' Sd'imie) > 0)); then 
echo "\iRemove files:* 
sed *n "s'Spanem! \l!p*Sdifnie 
sed -n 's!Spaaem!rm '\r*p* Sdiffile | 
{ 

j(f Do the standard setup 

echo -HOME-^expr -SO' : •\(.n)/admAjin/-*' 
echo *. SHOME/.cronprofile* 
# Now get (he user commands 
cat 

55 
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) > Sonpcmdrile 

rex -cv -p SEXPPKGID -r priv -P SEXPPWD Saltuid -M SSERVERMAIL -f Stmpcmdftle name* -SCUENTID 

n 



ff < sendchmods 

# This rotttixK stnds chmod commands to a diem 

sendchmodsO { 
typeset CUENTtD-Sl difrile-$2 
typeset pancni«*n((0-91*\)\(.*\)$* # chmods file pattern 

ir(( $<grep -c -Spanern* SdifTtle) > 0)). then 
ecbo 'XtChange fUei:' 

sed -n -slSpanem! W \2!p" Sdiffilc 

sed -n 'siSpaoemlchmod M *\2'*p' SdifTile | 

{ 

jgr Do cbe standaid setup 

echo 'HOKfE-'cxpr "W . -\<.*\Vadmrtrin/'^' 
20 echo XHOME/.cronprofilc' 

0 Now get the user commands 
cat 

} > StmpcmdfUe 

rex <cv -p SEXPPKGID -r pnv -P SEXPPWD Salmid -M SSERVERMAIL -f Stmpcmdfile name^ -SCUENTID 

fi 

25 ) 



$ < seodrrmdirs 

# 

30 sendrrmdirsO { 

typeset CUENTID«*S1 difnie*"$2 

typeset pancrn»'*- \(.*\)/S' 0 directory pattern 

\t (( S(grep -c *Spanem* SdifTtle) > 0)). dien 
echo "XcRemove directory:* 
35 sed -n 'sISpanern! M *p* SdtfTile 

sed -tt 'siSpatternt'd'M'fp' SdifTUe | 
sort -r I 

xargs -s3S0 echo dcletedirs | 0 echo the function we want 

eval *S(cat)* 0 exec constructed f^ncnon 

fi 



40 



0 < sendrcpfUes 

0 

sendrqjfilcsQ { 

typeset CUENT!D«St difnte-S2 

integer onemeg-> 1049576 0 number of bytes in a one meg file 
integer baae I number oftaytcs in a block on this machine 

integer limit 0 maximum size of cpio file tn blocks 

typeset CPIOFLAGS 0 flags for cpio 

case $(macbtype) 

in ibm) bsize«4096 # ibm uses 4096-byte blocks 

:. pyr) bsize«204d if pyr uses 2048-byie blocks 
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*) bsizcs5 12 if everyone else uses 5 12-byte blocks 

esac 

([limit « onemeg / bsize)) /f calculate the blodc size limit of files 
5 sed <a •$!+ \(.*PW*\S!*\r !p' SdifWe > Stmpclist 

if [ -s 'Stmpclist' ); then 
integer sum bO size 
echo "UUpdate Ttles:* 
scd '5/V r Stmpclist 

> Stmpwiist 
1Q xargs Is -sd < Stmpclist | 

{ 

CPIOFtj\GS="-oc- 
if test "STYP" - 'mip"; then 
CPIO«expcpio 

else 

CPIO«cpio 
ifSSVR4:then 
CPIOFLACS---o-Hodc' 

fi 

fi 

while read -r size filename: do 
((sum = sum + size)) 
^ if [[ Ssum -gi Slimit -s Stmpwiist ]]; dien 

SCPIO SCPIOFLAGS < Stmpwiist > Stmpcpio 

Sdebug sendcpio -v -p SEXPPKGID -P SEXPPWD Saltuid -M SSERVERMAIL -f Stmpcpio 

name«-$CUENnD 

((sum » size)) 
> Stmpwiist 

25 t\ 

echo "Sfllenaroe* > > Stmpwiist 

done 

SCPIO SCPIOFLAGS < Stmpwiist > Stmpq)io 

Sdebug sendcpio -v -p SEXPPKGID -c -P SEXPPWD Saltuid -M SSERVERMAIL -f Stmpcpio name= =SCUENTID 

# < dirlog 

0 

^ dirlogO { 

typeset CUENTID^SI diffile-Sl 

sed -n "A/S/s%\(.«\).%*date +%y%m%d' \l%p* Sdiffile > > SUNKDIR/client/SCLIENTID/dirlog 

) 
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< updiog 

/f 

updIogO { 

. typeset CUENTID=S 1 dtfrile= S2 

sed-n 'mni%^%^aaxc +%y%m%d* ftp" SdifTile > > SliNKDIR/clieni/SCUEhmD/updlog 

> 



tf < pUstOK 
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plistOKQ { 

typeset plistfile«$ I 
typeset RC 

ifiest!-r'Sptisifile';theQ 
RC-I 

eliftest ^(tul -I SplistfOe 2>/dev/nutl)* *- "SHOP; then 
RC-1 

else 

RC-0 

fl 

rerorn SRC 

} 



jjf < pkgfiicOK 

# 

pkgrtleOKO { 

typeset plcgrite«$l 
typeset RC 

iftes(!-r*Spkgnie*:dieo 
RC-I 

eliftest *$(cui -1 Spk^nie 2>/<tev/iiull)' !- *S£OF': (hen 
RC-1 

else 

RC»0 

fl 

return SRC 

} 



# < mlcioollist 

# 

# This rouune returns a full list of the tools subscribed to in the fUe 
M given as argumenL 

mIciooUistO { 
typeset RC 

> SerrfiieZ # begin with no error condition 

> StmpsubscrZ 9 begin with no cool list initially 
for subfile, do 

U eliminate conuaents and blaidc lines 

( CteanComm < SsubfUe 1 1 echo 'CleanComm S?* >SerrfUe2 :) | 
U get excluded tool names 

{ scd TptJ/d; s/*!/r 1 1 echo "scd S?" >$erTfile2 ;} | 
$ expand any mgt*iMmg« 

( expandtools 1 1 echo 'expandtools S?" >SerrfUe2 ,} | 
Jtf sort the list 

{ sort -u > Stmpexctudc 1 1 echo *sortS?' >Serrrile2 ;} 
if test -s SerrfileZ: then break; fl f Break out of loop on error 
9 move previous tool list 

{ mv Stmpsubscr2 StmpsubscrL 1 1 echo *mv S7* >$errrile2 ,} 
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if test -$ $crrfilc2; then break; fi 0 Break out of loop on error 
ft eliminate comments and blank lines 

{ CleanComm < Ssubfile 1 1 ectao "CleanComm $?* >$errrite2 :} | 

if get subscribed tool names 

{ scd 'n/d* 1 1 echo "sed $?" >$crrfilc2 ;) | 

ft expand any metanames 

{ expand tools 1 1 echo 'expandtools S?* >Serrrile2 ;} | 
ft add previous toots and sort them 
{ sort -u - Stmpsubscrl 1 1 echo "sort $7" >$erTfile2 :} | 
if remove the excluded names 

{ comm -23 - Stmpcxclude > $tmpsubscr2 1 1 echo "comm $?* >$crrfile2 ;} 

if test -s $errfilc2; then break; fi ff Break out of loop on error 
done 

if (est -s Serrrile2; then 

read ECMD ECODE < $errfile2 

echo '$0: Error SECODE' reported by SECMD'" >&2 

RC=»SECODE 

else 

cat Stmpsubscr2 tf return the final list 

RC=0 

n 

remrn SRC 



tf : < extractsection 

# 

This routine extracts given sections of input files that are terminated by 
if the EOF line. 

extractsection() { 
integer section=Sl 
typeset tnputfile==:S2 
integer i=-I 

typeset LINE done- false 



while not Sdone read LINE; do 
if ((i > section)); then 

donestruc 
clif test "SUNE" » •$EOP: men 

{(i D) 

^ clif {(i ~ - section)); then 

echo "SUNE" 

n 

done < Sinputfile 

) 



-< mailnews 



mailnews() { 

typeset NEWSTIME=$HOME/.mailnewsjimc NEWSDIR«$ADMRUG/ncws 

50 if test -d SNEWSDIR -a -n "$*"; then 

cd SNEWSDIR 
for file in S(ls -tr); do 

if test Sfilc -ni SNEWSTIME; then 
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n 

done - 
cd- 

fi 

^0 touch SNEWSmfE 

) 
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ccbo '\tAnnouDcmem 'Snie* mailed to S** 
{ 

echo 'Subject: Exp tools announcement' 
echo 
cat Sfile 
} I /bin/mai] S* 



-< salutation 



saluiaiionO { 
^5 if not SSALUTATION; then 

SALUTATION- true 
e 



echo * — > To the Exptools Administrator of server SLOCALQ):" 

fi 

} 



# < clicotsort 

# 

ff This routine sorts clients based on the depth and number of machine in the 
cascade they serve. This allows clients who have deeper and more numerous 
cascades to get their tools Ttrst and begin serving them sooner. 

clicntsortO { 
typeset CL 

integer DEPTH MAXDEPTH MACHCOUNT WHGHT 

for CL: do 

30 typeset PKGFILE=. $HOME/ric/SLOCAUD/$CL.pkg 

MAXDEPTH-0 MACHCOUNT«0 WEIGHTED 
if test -f SPKGFILE; then 
extractsection 3 SPKGFILE | 
while IFS«: read DEPTH REST; do 

if ((MAXDEPTH < DEPTH)): then 
35 ((MAXDEPTH » DEPTH)) 

n 

if ((DEPTH t)); then 
{(MACHCOUNT += 1)) 

n 

done 

((WEIGHT » MAXDEPTH + MACHCOUNT/4)) 

40 fi 

echo-SWEIGHT SCL" 

done I 

sort +0 -Inr +1 ) 
while read DEPTH CL; do 
echo "SCL" 

45 done 
} 



# < main 
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autoload take 
cd 

GETOPT>S(getoptcdprRl:t: *S9") 
tr((S?!-0)); dien 

echo "SUSACE* 

exit 2 

n 

set - SGETOPT 

debug*"' 

LOCAUD-" 

RESEND-ftise 

CHECKSUMS-fabe 

USEPUST-false 

NULL MEANS ALL-true 

${H«ESHOLb:-i200} 
for arg lo "S^'i do 

case 'Sarg* in 

-c) 

CHECKSUMS-Cruc 

shin 

^) 

debug*" echo 

shift 

•r) 

RESEND-tnic 

NUU._M£ANS_ALL-false 

shift 

-R) 

RES END « true 
shift 

-P) 

USEPUST-true 
shift 

■1) 

THRESH0LD-S2 
shift 2 

■i) 

L0CAUD-S2 
shift 2 

") 

shift 
break 

csac 
done 

CUENTUST-*S®* 

if test ! -rSADMRUG^glob&l/coiirtg: dten 
echo 'SCMD: ERROR: Can't find RUG global conTig file* 
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exit 3 

n 

. SADMRUG/global/config 

iftcsr -n "SLOCAUD"; then 
FOUND=fal«c 

for ID in SDEFAULTLOCALID SLOCALIDUST; do 
if test "$ID" « 'SLOCAUD*; then 
FOUND=truc 

n 

done 

if not SFOUND; then 

echo "SCMD: ERROR: Unknown local server !D 'SLOCAUD' given - aborting!* 
exit 2 

fl 
else 

if test -z -SDEFAULIXOCAUD"; then 

echo *SCMD: ERROR: Default local server ID missing - aborting!' 
exit 2 

fl 

UX:AUD= SDEFAULTLOCAUD 

fi 

. SADMRUG/global/linkconfig SLOCAUD 

outnie« SUNKDIR/scrver/update. out 

if test {(find Soutfile -mtime + 1 -print | wc -I) -ne 0; then 

S£NDUPDATES_DORMANT=>tnie P Sendupdates has been asleep! 

else 

SENDUPDATES DORMA^^^>Es false Sendupdates running as usual 

fi 

Sdcbugcval 'exec > Soutfile 2 
echo "Start 'date'Xn' 

EXPTAB=$UNKDIR/server/expiab export EXPTAB 

EXPPKGID =i=$LOCAUD 

RJE=$HOME/rjc/SLOCAUD 

NEWFILES-$HOME/adm/updl . 1/Iib/cpio.ncw 

NEWnLESCOPY= JHOME/adm/updl. l/lib/cpio.ncw2 

: ${tmp:»/usr/tinp} 

rnipCignore^Stmp/SSCtgnore 0 List of files to ignore from Client 

tmpS ignores Stmp/SSStgnore # List of files to ignore from Server 
tmpignftle=5tmp/$Signftle if Work ftte of files to ignore 
tmpdiff=Stmp/S$pdifT # List of files to change on client 

tmpclisisStmp/SSctist M List of files to cpio to client 

tmpplist=Stmp/SSplist J(f Sorted, uncommented client pltst 

tmpwlist==Stmp/SSwtist 0 List of flics It size limit to cpio 

mipcpio=$tmp/S$cpio If Cpio flle to send to client 

tmpexclude=Stmp/S$excl ff Work list of excluded tools 

tmpsubscrl -Stmp/SSsubl ff Work list of subscribed tools 

tmp5ubscr2=Stmp/$$sub2 ff Work list of subscribed tools 

tmpCNTmodet=Stmp/$SCmodel ff Names of flies desired by client 

tmpCNTplist»$tmp/SSCptist ff Client plist with excluded flies removed 
unpSRVtool5»Strop/SSStools 0 List of tools offered 
tmpSRVplist=Stmp/SSSplist ff Plist of flies offered to client 
tmppkgflle"Stmp/$Spkgflle ff Work flle of packages client subscribes to 
tmpflies >s Scmp/SSflles if Work flle of flle names 

tmpcmdflle=$trop/SScmds ff Work flle for commands to be sent 

crrflle=Stmp/SSerrflle ff Flag flle for detecting errors in pipes 
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ciTfitc2= Stmp/SSerrfile tf Flag file for detecting errors in pipes 

unpnists'StmpCigaore StmpSignore Stmpigofite SunpdifT Sbnpclist Stmpplist Stmpwltst Simpq)to Stmpcxcludc StmpCNTmodel 
StmpCNTpltst SunpSRVcools SunpSRVplist Stmppkgfile Stmpfllcs Stmpcmdfilc Stmpsubscrl StmpsubscrZ Scrrfile Scrrtllc2' 

rctval=»0 
trap ■ 

r«vaJ=3 1 

exit 

trap * 

trap - ERR 

cmsg 'Error code Srecval detected* 

exit Sretval 
* ERR 
trap * * 

Sdcbug rm -f Stmpflist 

{ 

echo "Subject: SLOCAUD gateway runJogXn' 
cat SoutTile 

}| 

Sdebug /bin/mait $ADMIN_EMAIL 
exit Sretval 
EXIT 

if $SENDUPDATES_DORMANT: then 

echo *****>***********A*«***************«*********************" 

echo "WARNING: Sendupdates has not been run for over 48 hours!\a* 

n 

SRVplist=SLlNKDIR/servcr/plist.$yRDAY 
SRVnist=SUNKDIR/$crver/nist 
for file in SLINKDIR/server/plist.*: do 
if [ 'Sfile" !« -SSRVplUr ); then 

rm-rsnic 

fi 

done 

if lest 'Z "SCUENTUST- SlSl SNUIX MEANS ALL; then 
CUENTUST= * findclicnt STYPE^ ~ 

n 

echo 'Clients: 
SCLIENTUST" 

if SRESEND: then 

for CUENTID in SCUENTLIST; do 

CLIENnD^$(takc 8 SCUENTID) 

EXPPWD»$UNkDIR/clicnt/$CUE>mD/.pwd 

if test -s SUNKDIR/client/SCUENTID/uidname; then 

alniid » < $LINKDIR/clicnt/$CLIENTID/uidname)" 
else 
altuid= 

n 

tmpdiff»$RJE/$CLIENTID.diff 

SUSPENDED-SUNKDIR/clicnt/SCUENTID/Suspcnded 
if test! -f Stropdiff: then 

echo 'Xn— > No diff file found for JCUENTIDXa" 
eltftest -fSSUSPENDED &&, SNULL_N4£ANS_ALL: then 

echo '\n— > Client SCUENTID currently suspended' 
etsc 
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cc"*wc-l < StmpdifT 
if("$cc*^01;ihen 

echo *\a\tNo updates for SCUESTID' 

else 

^ echo "\n\tChM8c$ for $CU£NT1D: • $cc 

sendddfUes SCUENTID StmpdifT 
seodrnndirs SCUENTO) StmpdifT 
sendchmods SCUENTID Stmpdiff 
scDdrepraes SCUEffTID StmpdifT 
dirlog SCUENTID Stn^NUrr 
updlog SCUENTID StmpdifT 

fi 

n 

done 

elif SUSEPUST 1 1 SCHECKSUMS 1 1 ootplistOK SSRVplist; then 

75 ( 

catSEXCLUDEUST 

genliidcdin SLOCAUD 
} I mksed > StmpSignore 
if SUSEPUST; dien 

echo 'VnAccepting current checksums 

20 

echo *ViiCreatiQg upward cascade map* 
UPDUX5-STOOLS/adm/upd I . l/tih/updlog 
CPIOUXi-STOOLS/adm/updl . 1/lib/cpio.log 
TZmSOLD TZdaie | read X X X X TIMEZONE REST 
MONTH -"date* 
25 DAY-*UNKNOWN!" 

TIME-" 

If test -f SCPIOUXS -a * -f SADMRUG/.over. dien 
TZ-S0LD_TZIs-I$CPI0UX3 I readXXXXX MONTH DAY TIMEREST 
TIME»"STTME STMEZONE' 
clif test -f SUPDLXX}; then 
30 TZ-SOU) T2 Is -I SUPDLOG | read X X X X X MONTH DA Y TIME REST 

TIME- -STTME STMEZONE* 

n 

integer UEVEL 

CASCADEFILE«SUNKDIR/glotMd/cascade 
echo M:SL0CAUD:SMONTH SDAY STIME- > SCASCADEFILE 
35 for ID m SDEFAULTSERVERID SSERVERIDUST: do 

if test -r SADMRUG/SID/global/cascadr, dien 

while IFS-: read LEVEL SERVER TIMESTAMP: do 
((LEVEL +- D) 

echo *SL£VEL:SSERVER:STIMESTAMP' 
done < SADMRUO/SID/global/cucade > > SCASCADEFILE 

40 fi 
done 

cbmod 664 SCASCADEFILE 
cat SCASCADEFILE 
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echo 'VnCreating downward cascade map' 

{ 

echo '\aNOTE: This cascade map geocrated S(date)* 
showtree -I SLOCAUD 
} > SUNKDIR/locaJ/cascade 

echo 'XnChedung on exptoots announcements* 

( 

LOCAL ADMIN EMAIL-SADMIN EMAIL 
if test -n"*SDEFAULTSERVERID"; tten 

. SADMRUG/global/linkcottflg SDEFAULTSERVERID 
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SERVER_ADMIN_EMAIL«SADMIN_EMAIL 

else 

SERVER ADMIN_EMAIL-" 

n 

iftcsi-$LOCAL_ADMIN_EMAIL" !« '$SERVER__ADMIN EMAIL", then 
mailnews SLOCAL ADMIN EMAIL 

fi 

) 

echo "NoCaiculaiing new checksums 

rm -rSRJE/UpdateStaned SRJE/UpdatcEnded SRJE/RequescEndcd Serrfiie 
{ 

mktoolltst SSUBSCRLIST 1 1 echo 'mlctoollist S?' > Serrfiie 
} > StmpSRVtoots 

if test -s Serrfiie: then 

emsg 'Failure preparing server tool list' 'S( < Serrfiie)' 
rm -f StmpSRV tools 
exit 2 

n 

if test ! -s StmpSRVtoots: then 

echo "SCMD: ERROR: No tools being served by this server - aborting!" 
exit 2 

fi 

if not fgrep -x updtools StropSRVtools >/<lev/null 2>&1: then 
25 echo *SCMD: ERROR: Essential tool 'updtools' not being served - ab<mtng!' 

exit 2 

fi 
{ 

# Get filenames for tools served 

{ TOOLS=SHOME STOOLS/adm/updl . l/bin/prpkg -ir < StmpSRVtools 1 1 

echo -prpkg $?• > Serrfiie;} | 

If Put in sorted order 

{ sort -u 11 echo 'sort S?" > Serrfiie ;} ( 

If Add directories to complete list 

{ STADMRUG/bin/dirfilloui 1 1 echo "dirfillout S?" > Serrfiie ;} | 

If Remove server-ignored files 

{ sed -f StmpSignore 1 1 echo 'sed S?" > Serrfiie ;} | 

# Get plist data for given files \ 

{ time STADMRUG/bin/mkpIist -m 1 1 echo "mlcpltst $?" >Serrnic ;} | 
If Put in sorted order 

{ sort -u II echo 'sort $?" >$crTfilc ;} 

40 echo -SEOF" 

} > SSRVplist 

if test -s Serrfiie; then 

emsg "Failure preparing server chedcsums' "%{< Serrfiie)" 
exit 2 

fi 

fi 

if not plistOK SSRVplist; then 

echo "SCMD: ERROR: Corrupted plist file SSRVplisr - aborting!* 
exit 2 

fi 

50 nn -f SNEWFILES If Remove previous list of new files 

if not SUSEPUST; then 

> SRJE/UpdatcStarted 

fi 
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OVERTHRESHOLD»falsc 
LONGTERMPROB false 
MISSINGR£PORT» false 
SUBSCRIBE_£RROR-false 
^ echo 'XnCurreoi update threshold: STHRESHOLD* 

echo *\nThe clients below are processed according to the sizes of their cascades,* 
echo 'largest first* 

for CUENTID in S(cIieDtsort SCUENTUST); do 
CUENTlD»$(talce 8 SCUENTID) 
clcanupclient SCUENTID SYRDAY 
10 SUSP£NDED=$UNfU)IR/caent/SCU£NTID/Suspended 
if test -f SSUSPENDED: then 

echo "\tt— > Client SCUENTID currently suspended' 
else 

EXPPWD-SUNKDtR/client/SCUENTID/.pwd 
if test -s SUNKDIR/client/SCUENTID/uidname: then 
15 alntid»''-u$(< SUNKDIR/client/$Cli£NTID/uidnanie)* 

else 

altuid» 
fi * 

CNTpIist«$RJE/$CUENTlD.XYRDAY 
CNTplcgfilc-SRJE/SCUENTID.plcg 
2Q if not plistOK SCNTpIisc then 

if test ! -f SCNTpIisi; then 
MISSINGREPORT«truc 

echo *\n— > No plisi file found for $CLIENTID\a' 

integer DAYSOLDsO 

if test ! -f SCNTpkgnie: then 

echo ' No package file found for SCUENTID* 
^ elif not S5ENDUPDATES DORMANT <bic test -z •$(rind SCNTpkgftle -miime -3 -print 2 >/dev/ null)"; then 

DAYS0U)-»4 

while test -n •$(nnd SCNTpkgfilc -mtime +$DAYSOU) -print 2>/dcv/nutl)"; do 

((DAYS0U> +« D) 
done 

((DAYS0U> -= 1)) 

echo " TTiis client hasn*i reported for SDAYSOU) days!" 

fi 

if((DAYSDU>!-0)); then 

ADMINDATA- SUNKD[R/clicnt/SCUENTID/admindata 
if test -f SADMINDATA; then 
typeset NAME EMAIL 
35 while read FIEU> VALUE; do 

case "SF!FT 0" 

in NAME) NAME- "SVALUE* 

;; EMAIL) EMAIL =»'$VALUE" 

esac 

done < SADMINDATA 
40 if l[ "SEMAIL* ! « i^none | NONE | ") 1]; then 

( 

echo 'Subject: exptools errors' 
echo 

if ([ -SNAME* !=- ©(none i NONE r*) J); then 
echo*To$NAME:' 
45 echo 

fi 

echo "The RUG update code has detected an error. Your client 'SCUENTID' has not* 
echo 'reported to its server 'SLOCAUD* for the last SDAYSOLD days. Please check* 
echo "your system to see what is causing this problem. Consult the 'rugadm' HELP* 
echo 'subsystem for advice. The 'rugcheck* command may also be hclpM* 
^ echo 'in identifying the cause of this problem.' 

echo 
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echo *\(\t\t\tSLOCAUD ExptooU update routine* 
} I mail SEMAIL 

echo ' Waroing notice sent to SEMAIL.' 

else 

echo * No admuusmtor email address on file for 'SCUENTID' / 

echo * Wanung notice NOT SENT to dut machine's Exptools administrator. * 

n 

n 

If ((DAYS0LD%3 0)); dien 
{ 

echo "Subject: exptoola clienc trouble' 
echo 

echo 'The RUG update code has detected an error. The client 'SCUENTID' has not* 
echo 'reported to its server 'SLOCAUD' for die last SDAYSOLD days. Please contact' 
echo 'die exptools administrator of diat system to see what might be causing Uiis' 
echo 'problem. You can consult die 'rugadm' HELP subsystem for advice. ' 

echo 

echo '\t\t\l\tSLOCAUD Exptools update routine* 
) I maUSADMIN.EMAIL 
echo * Wanung noticesent to SADNfIN EMAIL.* 

n 

fi 

else 

echo *\ii — > Corrupted plist Tile found for SCUENTIDva* 

ft 

clir not pkgnieOK SCNTplcgrile: tiien 
If test • -f SCNTpkgfile; dien 
MISSIHGR£PORT«true 

echo 'Xn— > No padcage file found for SCUENTIDXa* 
else 

echo 'Vn— > Corrupted padcage ftle found for SCUENTXDXa' 

fl 

else 

echo •\nProcessiiig SCUENTID 'dale' " 

sleep 10 # Allow odier processes to be cleaned up 

> Serrfile 

if test • -f StmpSRVtools: then 
{ 

rnktooliist SSUBSCRLIST 1 1 echo 'miooollist $?* > Serrfile 
) > StmpSRVtools 

if test *s Serrfile; dien 

emsg 'Failure preparing server tool list* *S(< Serrfile)* 
rm -f StmpSRVtools 
exit 2 

fl 

if test ! -s StmpSRVtools; then 

echo "SCMD: ERROR: No tooU being served by Ais server - aborting!' 
exit Z 

fl 

if not fgrep -x updtoots SmipSRVtools >/dev/null 2> Al. tfien 

echo 'SCMD: ERROR: Essential tool 'updtools' not being served - abomng!' 
exit 2 

fl 

fl 

cxtractsection 1 SCNTpkgflle > Stmppkgflle 
extractsectioo 2 SCNTpkgflle | 
mksed > SctnpCignore 
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if test ! -s Stroppkgfile; then 

echo '$CMD: ERROR: No tools being requested by this client - skipping* • 

SUBSCRJBE,£RROR»true 

continue 

ft 



if not fgrep -x updtools Stmppkgfile >/dev/null 2>&1; then 

echo "SCNfD: ERROR: EssendaJ tool 'updtooli* not requested - slcipping!" 

SUBSCRIBE_ERROR»true 

continue 

n 



{ 

ff Get tools subscribed to 

{ mkiooUisi Stmpplcgfilc 1 1 echo •mktoollist $?• >$cTTnic ;) | 
ft Intersect with offered tools 

{ coram -12 - SimpSRVtools 1 1 echo •conun $?" >SerrfiIc ;) | 
# Get nienamcs 

{ TOOLS=SHOM£ STOOLS/adm/updI.l/bin/prpkg -ir 1 1 

echo 'prpkg $?" >$errrilc;} | 

tf Put in sorted order 

{ sort -u II echo "sort $?" >$crrfilc ;> | 

ff Add missing dirs to list 

{ $TADMRUO/bin/dirfillout 1 1 echo •dirfillout $?" >SerTrile ;} | 
tf Remove client-ignored Tiles 

{ sed -f StmpCignore 1 1 echo "sed $?" >$errnie ;} | 

ff Put in plist form w/o csums 

{ STADMRUG/bin/mkptist < 1 1 echo "mkplistS?* >Serrfile :} | 
0 Put in sorted order 

{sort-u II echo-sorts?- >$errfile;} I 

{ /usr/bin/join -j I -f * - SSRVplist 1 1 

echo "joins?' >Serrfile:} 

} > StmpCNTmodel 

if test -s Serrfile: then 
cmsg "Failure analyzing client SCUENTID checksums" "$( < Serrfilc)" 
continue 

n 



if test ! -s StmpCNTmodel: then 

echo "SCMD: ERROR: No files being requested by this client - skq>ping!' 

SUBSCRIBE_ERROR»true 

continue 



CleanComm < SCNTplisi j ff Clean out any comments 

sort -u > Stmpplist ff Make sure die file is sorted 

cut -f 1 Stmpplist I Xf Get the diem filenames 

sed -f StmpSignore | ff Remove server-ignored files 

/usr/bin/join -j 1 -t* * - Stmpplist > StmpCNTplist 

STADMRUG/bin/dif^list -m StmpCNTmodel -s StmpCNTplist > Stmpdiff 

PROBFILE=$RJE/.prob.SCUENTn) 

cc«*wc-l < SlmpdifT 

if fgrep -X -c "- .profile" Stmpdiff >/dev/nuU 2>&1; then 

echo "SCMD: ERROR: Update requests for this client corrupted - skipping! " 
clif ( "Sec" -gt STHRESHOLD J; then 

echo "\t > Too many updates for SCUENTID: Sec - skipping\a' 

if test -f SPROBFILE; then 

if test -2 "$(find SPROBRLE -mlimc -3 -print 2>/dcv/null)"; then 
integer DAYS0LD°4 
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fl 



while test -n 'S(find SPROBFILE -mtinie +SDAYSOLD -print 2>/dev/nuU)-; do 
((DAYSOLD I)) 

done 

((DAYSOLD -= I)) 

if ((DAYSOLD > 7)): then 

LONGTERMPROB«tnic 

STARS-'*** " 

else 

STARS-- 

n 

echo "Vt S{STARS}This client has been over threshold for SDAYSOLD days!* 



else 



> SPROBFILE 
OVERTHRESHOLD » true 



75 fl 

clif I "Sec" -cqO ]; then 
nn-f SPROBFILE 

echo '\tNo updates for SCUENTID* 
else 

rra-f SPROBFILE 

20 echo *\iChangcs for SCUENTID: * Sec 

senddeinies SCUENTID Stmpdiff 

sendrrmdirs SCUEhfTID Stmpdiff 

sendchmods SCLIEhfTID Stmpdiff 

seodrcpfiles SCUENTID Stmpdiff 

dirlog SCUENTID Stmpdiff 
25 updiog SCUENTID Stmpdiff 

n 

cp Stmpdiff SRJE/SCUENTID.diff 

fi 

fi 

done 

30 SALUTATION«falsc 

if SOVERTHRESHOLD; then 
salutation 
cat < <-! 

^ Some systems have EXCEEDED the nightly update threshold. Systems with more 

than STHRESHOLD changes will not be updated except through the express approval 
of the cxptools administrator. See the rugadm HELP screen "Approving the 
resending of update files to client machines" to see how to issue such an 
approval. 

^ ************«*«*«**«««««««*«•««»«***♦*«««*«♦♦***««•»***♦««»«««««»«*«««*«««#»» 

fl 

if SLONGTERMPROB; then 
salutation 
cat < <-! 

45 

Some systems have been over threshold for 7 days or more! Please determine 
why these systems have not gotten their updates. 

****««««***«**«*«********«****»«««»***«***«****««**«««««**««««**««**«*«**«*«« 

I 

50 fi 

if SMISSINGREPORT; then 
salutation 
cat < < -! 
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«*«»*»**«*«««««*«*«*******«**«**«*****************«*•*****«******«**«****««** 

Some clients did not send in their nigbtly reports in time to be included in 
today's update processing. Sec tbe rugadm HELP screen "Chcdcing on client 
reports" for tips on bow to handle this problem. 

««««»«»»«»«»****««««*»*««««««««***«*«««*««*****«**«*****«*««*«*«****«««««**«« 
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fi 

if SSUBSCRIBE_ERROR; then 
salutation 
cat < < -1 

Some clients have problems with their subscription lists. See the rugadm 

HELP screen 'Understanding RUG ERROR messages* for tips on how to handle this 

problem. 

«««*«*«**«««*«*««*«««««*«*«*«««*««««««««**«««*«*««*«*««**•«»**»**««««••«••««* 



fi 

if not SUSEPLIST; then 

> SRJE/UpdatcEnded 

ft 

elif test -s SNEWFILES: then 

echo *\nSending out newly arrived files 
cp SNEWFILES SNEWFILESCOPY 
( 

cat SEXCLUDELIST 
gcnlinkdirs SLOCALID 
} I mlcsed -w > StmpSignore 
for CUENTID in SCUENTUST: do 

EXPPWD»$LIhfKDIR/clicni/$CLIENTID/.pwd 

if test -s SLIKKDIR/client/SCLIENTID/uidname: then 

altutd»*-uS(< SUNKDIR/client/SCUENTID/uidname)' 
else 
altuids 

fi 

CNTplcgfile«$RJE/$CUENTID.plcg 
if notplcgfileOK SCNTptcgfile: then 
if test ! -f SCNTplcgfikr; then 

echo *\n — > No package file found for SCUENTIDVa" 

else 

echo *\n— > Corrupted padcage file found for SCUEhfTIDXa' 
fi 
else 

echo "VnProcessing SCLIENTID ' date^ " 
> Scrrfile 

^ if test ! -f StmpSRVtools; then 

{ 

mlctoollist SSUBSCRUST 1 1 echo 'mktoollist $?* > Scrrfile 
} > StmpSRVtools 

fi 

45 if test -s Scrrfile; then 

cmsg 'Failure preparing server tool list" '$(< Scrrfile)" 

rm -f StmpSRVtools 

exitZ 

fi 

50 if test \ -s StmpSRVtools; then 

echo 'SCMD: ERROR: No tools being served by this server - aborting!' 
exit 2 

fi 
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extnctsecuon 1 SCNTpkgfile > Stmppkgfile 
extnctsecaon 2 SCNTplcf^ile | 

rolcsed > StmpCignore # Clteru-ignored fiies. scdscr 

if test ! -s Stmppkgrile; then 

ccbo 'SCMD- ERROR: No tools being requested by (his citcot - dcippiog!* 
cominue 

n 

sed -f ScnpCignore SNEWFILES | » Remove clieiit-igiiored files 
TOOLS -SHOME STOOLS/adm/u(Ktl . 1/bin/pkgpatb 4 | # Get toolnames 
sort -u > StmpCNTmodel 0 Sort new tool:fUe list 



Hf Get cooU subscribed to 

{ rnktoollist StmppkgTile | \ echo *inkXoollist S?* > Serrfde :) | 
0 (mersect with offered toob 

{ comm -12 - StmpSRViools 1 1 echo *comro %V >$entUe .} | 
0 Put in sorted order 

{ sort -u II echo *son $?' >$errfile ;) | 

tf Join with Dcw tool: file list 

{ /usr/bin/join -t: - Stn^NTmodel 1 1 

echo •join $?" > SerrTile ;) I 

9 Extract die file names 

{cut^:-f2 II echo •cut $?■ >$crrfilc.> j 

0 Put in sorted order 

{ son -tt II echo 'sort S?* >Serrrile ;} | 

# Put in update form 

{ sed •$/«/+ &/* 1 1 echo ^scd %V > Setrfile ;} 
} > StmpdifT 

iftcst-sScrrfile: dien 

erosg "Failure analyzing client SCUENTtD checksums* "S(< Serrflle)* 
conuaue 

fi 

cc«*wc-l < Stmpdirr 
if["$cc*-cqO);ihen 

echo *\tNo updates for SCUENTtD* 

else 

echo '\tChaflges for SCUENTID: ' Sec 
sendrepfiles SCLIENITD StmpdifT 
updlog SCUENTID StmpdifT 

n 

cp StmpdifT SRiE/SCUENTID.diff2 

n 

done 

If cmp -s SNEWHLES SNEWFILESCORY; tficn 
rro SNEWFILES SNEWFILESCOPY 

else 

comm -13 SNEWFILES SNEWFILESCORY > Stmpfiles 

mv Stmpfiles SNEWFILES 

rmSNEWFILESCOPY 

fi 
else 

echo '\nNo reason to send files* none will be sent!* 

n 

echo "VnFinish 'date" 

Sdcbug cat SoutfUe > > SUNKDIR/server/Runlog 
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Claims 

1 . A system for propogating revisions through a communications network, comprising: 

5 status reporting circuitry, associated with a second node of said communications network, for collecting arxJ 

transmitting a current status of second node information stored in a memory of said second node; 

first information revising circuitry, associated with a first node of said communications network, for receiving 
said cunent status from said second node, determining as a function of said current status whether a revision 
10 of said second node information is required and, if said revision is required, transmitting said revision to said 

second node to revise said second node information; and 

second informatbn revising circuitry, associated with said second node of said comntunications network, for 
receiving a current status from a third node of said communications networK determining as a function of said 
15 current status from said third node whether a re/ision of third node information stored in a memory of said tfiird 

node is required and. if said revision is required, transmitting said revision received from said first node to said 
third node to revise said third node information, said revision thereby propagating through said communica- 
tions network via said first, second and third nodes thereof. 

20 2. The system as recited in Claim 1 wherein said second information revising circuitry includes memory for storing a 
sut)scriber list, said second information revising drcurtry transmitting said revision as a function of a content of said 
subscriber list. 

3. The system as recited in Claim 1 wherein said status reporting circuitry coHects and transmits said current status 
25 of said second node information to said first node at a first time, status information circutry associated with said 
third node collecting and transmitting said current status from said third node to said second node at a second time, 
said second time subsequent to said first time by a period of time sufficient to allow said second node information 
to be fully revised before said second information revising drcuitry transmits said revision to said tiiird node. 

30 4. The system as recited in Claim 1 wherein said second information revising circuitry is embodied in a sequence of 
instructions operable on a second processor associated with said second node, said revision capable of including 
revisions to said sequence of instructions, thereby allowing an operation of said second information revising cir- 
cuitry to be modified. 

35 5. The system as recited in Claim 1 wherein said communications network is hierarchical, said first node functioning 
as a server for said second node, saki second node functioning as a server for said third noda 

6. The system as recited in Claim 1 wherein said first information revising circuitry includes first security circuitry for 
authenticating sakl current status received from said second node before saki first node transmits saki revision to 

40 said second node and said second node includes second security circuHry for authenticating saki revision received 
from said first node before revising said second node information. 

7. The system as recited in Claim 1 wherein said first information revising circuitry revises said secorxl node informa- 
tbn by logging on to said second node and transmitting a sequence of commands to said second node to enable 

45 said second node to receive saki revision. 

8. A method of operation of a communications network for propagating revisions through said communicatk>ns net- 
work, comprising the steps of: 

50 collecting and transmitting a current status of second node information stored in a memory of a second node 

of said communications network; 

receiving saki current status from said second node into a first node of said communications network, said first 
node determining as a function of said current status whettier a revision of saki second node information is 
55 required and. if saki revision is required, transmitting said revision to said second node to revise saki secorxi 

node information; and 

receiving a current status from a third node of sad conrununications network into said second node, said sec- 
ond node determining as a function of said current status from said third node whetiier a revision of third node 
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information stored in a meniory of said third node is required and, if said revision is required, transmitting said 
revision received from said first node to said third node to revise said third node information, said revision 
thereby propagating through said communications network via said first, second and third nodes thereof. 

5 9. The method as recited in Claim 8 wherein said step of receiving said current status from said third node connprises 
the step of transmitting said revision as a function of a content of a subscriber list stored in said memory of said 
second node. 

10. The method as recited in Claim 8 wherein said current status of said secorxJ node irrformation is collected and 
10 transmitted to said first node at a first time, said method further comprising the step of collecting and transmitting 
said current status from said third node to said second node at a secorxJ time, said second time subsequent to said 
first time by a period of time sufficient to allow said second node infbnriation to be fully revised before said second 
information revising circuitry transmits said revision to said third node. 

15 11. TTie method as recited in Claim 8 wherein said second node includes a sequence of instructions operat>le on a sec- 
ond processor associated with said second node, said revision capable of including revisions to said sequence of 
instructions, thereby allowing an operation of said second node to be modified. 

12. The method as recited in Claim 8 wherein said communications network is hierarchical, said first node functioning 
20 as a server for said second node, said second node functioning as a server for said third node. 

1 3. The method as recited in Claim 8 further comprising the steps of: 

authenticating said current status received from said second node before said first node transmits said revision 
25 to said second node; and 

authenticating said revision received from said first node before revising said second node information. 

14. The method as recited in Claim 8 saki step of receiving sakJ cunent status from said second node into saki first 
30 node comprises tiie step of reusing saki second node information by logging on to said second node and transmit- 
ting a sequence of commands to said second node to enable said second node to receive said revision. 

1 5. A system for propogating revisions through a hierarchical communications network having a host a first-level node 
and a second-level node, comprising: 

35 

status reporting circuitry, associated with saki f irst-le^el node, for collecting and transmitting a current status of 
first-level node information stored in a memory of said first-level node at a first time; 

first information revising circuitry, associated with said host, for receiving said cunrent status from said first-level 
40 node, determining as a function of said current status whether a revisfon of said first-level node information is 

required and, if said revision is required. transnMng said revision to said first-level node to revise said first- 
level node information; and 

second information revising circuitry, associated with said first-level node, for receiving a current status from 
45 said second-level node at a second time, determining as a function of said current status from said second- 

level node whether a revision of second-level node informatfon stored in a memory of said second-level node 
is required and, if said revision is required, transmitting saki revisfon received from saki host to saki second- 
level node to revise said second-level node information, said second time suk>sequent to said first time by a 
period of time sufficient to allow saki first-level node information to be fully revised t>efore said secorxi informa- 
50 tion revising circuitry transmits saki revision to said second-level node, said revision thereby propagating 

through saki communications network via said host, first-level and second-level nodes thereof. 

16. The system as recited in Claim 15 wherein saki second irtfbrmation revising circuitry includes memory for storing 
a subscriber list saki secorxi information revising circuitry transmitting saki revision as a function of a content of 

55 saki sul^scriber list 

17. The system as recited in Gaim 15 wherein said second information revising circuitry is embodied in a sequerwe of 
instructions operat)le on a second processor associated with said first-level node, saki revision capable of including 
revisions to said sequence of instructions, theret}y allowing an operation of saki second information revising cir- 
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cuitry to be modified. 

18. The system as recited in Claim 1 5 wherein said first information revising circuitry Includes first security circuitry for 
authenticating said current status received from said first-level node before said host transmits said re^sion to said 
first-level node and said first-level node includes secorxJ security circuitry for authenticating said revision received 
from said host before revising said first-level node information. 

19. The system as recited in Claim 15 wherein said second security circuitry authenticates said revision on a file-by- 
file basis. 

20. Tlie system as recited in Claim 15 wherein said first information revising circuitry revises said first-level node infor- 
mation by logging on to said first-level node and transmitting a sequence of commands to said first-level node to 
enable said first-level node to receive said revision. 

21 . A system for propagating revisions through a communications network, said communications network including at 
least one first level node, at least one second level node and at least one third level node, said system comprising: 

status reporting circuitry, associated with said at least one second level node, operative to collect and transmit 
a second level current status of information stored in a memory of said at least one second level node; 
first information revising circuitry, associated with said at least one first level node, operative to: (1) receive said 
second level current status of information from said at least one second level node, (2) determine, as a function 
of said second level current status of information, whether a revision of said at least one second level node 
information is required, and (3) selectively transmit, in response to said determination, said revision of said at 
least one second level node information to said at least one second level node to revise said at least one sec- 
ond level node information; and 

second information revising circuitry, associated with said at least one second level node, operative to: (1) 
receive a third level current status of information from said at least one third level node, (2) determine, as a 
function of said third level current status, whether a revision of said at least one third level node information 
stored in a memory of said at least one third level node is required, and (3) selectively transmit, in response to 
said determination, said revision received from saki at least one first level node to sakJ at least one third level 
node to revise sakI at least one third level node information, sakI revision thereby propagating through sad 
communications network via said at least one first level, at least one second level and at least one third level 
nodes thereof. 
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